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Copyright and right to make backup copies * On receipt of this computer program and 
associated documentation (the software), ATARI grants to you a nonexclusive license to execute 
the enclosed software and to make backup or archival copies of the computer program for your 
personal use only, and only on the condition that all copies are conspicuously marked with the 
same copyright notices as appear on the original* This software is copyrighted* You are 
prohibited from reproducing, translating, or distributing this software in any unauthorized 
manner* 










INTRODUCTION 


OVERVIEW 

This diskette contains preliminary versions of a few APX utilities* together with some 
demonstration and miscellaneous routines* Many of the programs contain rough spots* The 
contents of this diskette are subject to change without notice and such changes might not 
be reflected in this user manual* These routines are offered without follow-up support* 
The user manual does not conform to APX standards* In other words, the diskette and user 
documentation are offered strictly on as “as is" basis* 


REQUIRED ACCESSORIES 

ATARI BASIC Language Cartridge 

OPTIONAL ACCESSORIES 

ATARI 825 80-Column Printer 
One ATARI Joystick Controller 
Assembler Editor Cartridge 




ATARI UTILITIES DISKETTE 


This uti 1 i t ies disket,te is distr ibu't0d 1 0 out3id0 sof twere 
deve 1 opers 1 0 f a c i 1 i tate t-heir ef f or ts ♦ Thi s sof twar0 is n0 1 iri the 
public domain and is not to be distributed* The utilities in this 
package are* 
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DOS 2*OS 
DOS 2 ♦ O S 

bui 1 ds self“bootinq B ASIC prograns 
3 ri i n 1 0 g e r d i v i d e u t i 1 i t- y 
a s i g n e d i n t e g e r n u 1 t i p 1 y r o»j t i n e 
urisigned in1 0 ger n «j 11 i p 1 y routine 
a simple character set editor- 

cross-reference program for BASIC 

co n p r e ss es BA SIC pro gran s 

renuwbers BASIC progr a n s 

fornats LIST files fron ASSEMBLER 

B A SIC node S c har a cter print r ou tin e 

nakes fixed-length nunber records 

sin p 1e p1 3 yer-nissi1e graphics deno 

simple dis p1 a y list interrupt d e n o 

fu11 fine scroiling nodu1e 

o b J e c t c 0 d e 

a disk sector utility 

sinp 3..e horizonta 1 scr o 11 deno 

gives disk directories fron BASIC 

a very fast sort routine 

a character set animation deno 

t h e Ri device h a nd1e r 

n u 11 i p 1 e d i s p 1 a y 1 .i s t i n t e r r u p t deno 

player priority triek 

player as special character deno 

alternating display list deno 

sin p1e fine scroll d e n o 

sin p 1e vertical scroll deno 


None of these programs are fini5hed productsj they all 
r 0 u g h s p 0 1 s ♦ I f you nske inprovene ri ts pi e a s e send a copy to 
library* 


contain 
o u r 




C [-11 * =* RACTER EDITOR 


This program is *3 character editor that makes it easier to take 
advantage of the redefinable character set capability of the Atari* 
It gives you the capability to edit, load, or save character sets* 

The first Menu option is to create or edit a character set* If 
you enter this optiori without first loading a character set, it will 
default to a blank character set* You edit characters with the 
Joystick, selecting a pixel position with the stick 3 nd the status 
of that pixel (on or off) with the button* When you are done editing 
a character, you can allocate it to a character position with a 
keystroke indication* Fear not, nost operations are prompted, so 
that you can pick your way through the program rather well* The only 
blooper is that the prompt for an I/O operation to the disk requires 
that you give the DU prefix* 

This program is usable but not at all as practical as IRIDIS's 
FONTEDIT program* I strongly urge you to buy and study the IRIDIS 
program if you want to do any character set work* If only it had a 
display list interrupt*• 


SG HJN - E> - EDITOR- 

The sound editor helps you develop new sounds* It is nptFJ 
appropriate for developing tunes or jingles, or 3ny long sound* It 
is designed for developing short sounds (1 second long) such as 
clangs, croaks, rattles, and other such nonsense* It only edits two 
of the four sound channels* 

The program needs very little external documentation, as its 
title page describes the commands* The joystick response is slow, 
but you can use the 'fast' command to speed it up and then use the 
normal speed to fine tune your sound* You should read the hardware 
manual to get an idea of what the sound registers do* ' 

have 
it just 


Don't overlook the possibilities this program opens 
heard some very convincing sound effects created with it i 
takes a little imagination* 



— DC “T Y 


cr oss ie: f" e: f< e: m c ie: 

This utility provides a cross-reference of variables and 
constants in a BASIC proqr3fi* It requires at least ^ 0 K of RAM , a 
printer^ and 3 disk* Thee BASIC prograw to be cross-referenced should 
be on a diskette in SAVE fornat* The progran first gives a count of 
the total nuMber of variables used* For each variable, it lists all 
line nuttbers containing references to the variable* It also gives a 
count of how Many tines each constant is used* If an error occurs 
during printer output, you nay recover by typing GOTO 3050* 


F: FI M U 2^ 1E= El f< 

This progran will renunber your E:ASIC progran on disk* The 
target progran nust be on the diskette in LIST fornat* The progran 
pronpts you for the values it needs* The 'input device' will 
nornally be Dlprognane* The 'output device' will nornally be 
DJneuname* The 'starting nunber' is the new starting line nunber* 
'Fron' and 'to' are the beginning and ending line nunbers of the 
section of code you want renunbered* 



This progran will fornat the output of your Assenbler/Editor 
cartridge so that you can get a list file that looks good out of 
your Atari 825 printer* Make the first instruction of your assembly 
code a ♦OF’T NOEJECT* Then assemble the list file to the diskette* 
Then drop into BASIC and run this program* Respond to the name - 
prompt with Dlprognane. This program is designed for use with the 
Atari 825 printer, so good luck with anything else* 



MiAPSCROLL 


Mapscrall is a demonstration program module that shows one way to use fine scrolling 
effectively. It creates a large map in BASIC's graphics 2 mode using a redefined character set* 
The map is 32x64 pixels in size, but only 10x20 pixels are displayed on the screen at any one 
time. The user can scroll the screen window across the map with the joystick. The program was 
written for easy integration into other packages. 

Scrolling is achieved by coupling fine scrolling through the hardware fine scrolling 
registers with character scrolling by modifying the LMS bytes in the display list. The fine 
scrolling is straightforward; the character scrolling is somewhat more intricate. Each display 
byte in the display list has its LMS bit set. The following two bytes give the address of the 
display data. When the fine scrolling register overflows in the scrolling routine, the routine 
adjusts the bytes in the LMS addresses to point to the next character bytes. This adjustment is 
kept track of through a variable referred to as the offset. 

The other trick in the program is the redefinition of the character set into a graphics 
character set. The technique is very powerful} very few of the available characters in the 
character set are used and yet the resulting map is very believable. The map could be made even 
more realistic by using the other characters. By changing the character set at appropriate 
times the program could produce a variety of effects. 

The amount of system resource used is low. The module as written occupies 4K of RAM. This 
includes the map, the display list, the initialization routines, and the interrupt service 
routine that reads the joystick. Outside of thi*s the program uses 4 bytes of page zero (two of 
which are available after initialization is complete) and seven bytes of page six. The 
interrupt service routine is very fast so it will not significantly slow whatever main program 
you plug it into. Space has been left inside the 4K block for additions and modifications. The 
program is not fully relocatable as there are four patches that must be made to relocate it} 
however, these patches are well documented and easy to do. 

The easiest way to see this program in action is to BINARY LOAD it from DOS. The file name 
is SCRL19.0BJ. Then call it from BASIC with A=USR(27648). Plug a joystick into port 1 and 
scroll. At present the program does not interface well with BASIC} I have found that BASIC's 
cursor positioning gets lost. This reflects more on my laziness than on the program's 
tract ability. 



D. Yocum 
A/9/30 


CARE AND FEEDING OF "HASHER" 


HASHER is a utility program writen in BASIC which compreses other 
BASIC programs. Since it is intended For internal use only, there aj.e 
a Few "features" which the user should be aware of. 

1) All files are in LIST format. 

2) Do not use lines 0-9 in the source program. MASHER will use these lines 
for it s own variable definitions. 

3) Do not use the variables Q0 - Q999. HASHER uses these for constants. 

4) Do not branch to REMark statements. Besides being bad pratice, MASHER 

has problems sometimes with this. 

5) There is presently a bug with DATA statements. They are packed like any 
other statement. You will need to unpack these after MASHing. This bug 
will be fixed (someday). 

WHAT IT DOES 

HASHER will perform the following conversions on the source program 

1) Removes all REHarks 

2) Converts frequently used constants to variables. 

3) Packs small lines together to form long lines. 

NOTES 

This program will usually save between 55 - 405. Maximum compression occures 
when short lines are used in the source program. You must know the number 
of variables used in the source program. This can be obtained by running 



PMMOVE 


This program uses a machine language routine to move Players and Missiles. 
The routine is called by: 

USR(ADR(MOVES),PMNUMB,XPOS,YPOS) 

PMNUMB refers to the Player (0-3) or Missile (4-7) to move. The Missile 
number is determined by PMNUM8-4. XPOS and YPOS are the X and Y coordinates 
to place PM. A Relocator is used to make the PM Move routine wherever it 
may be placed in RAM by BASIC. 


BINARY ROUTINE 


This routine is included as part of the PMMOVE routine. BINARY loads or 
saves a binary file from BASIC. 


On entry 


CMD=7 

CMD=11 

STADR= 

BYTESr 

I0CB= 

FILE$= 


means load a file 
means save a file 

the address to load or save a file from 
the number of bytes to save or load 
the IOCB to use 
file name to load 


On exit ERRORrl means successful load 

ERR0RO1 means it's an error status 


BMUL 


This routine implements BOOTHS ALGORITHM for multiplication of SIGNED 
binary numbers in TWO 1 s-COMPLEMENT notation. 

The MULTIPLIER is shifted to the right with the PRODUCT (as usual). Each 
CHANGE of the MULTIPLIER bits from zero to one causes the MULTIPLICAND to 
be subtracted from the PRODUCT. Each change from one to zero causes it to 
be added. 

Like most signed arithmetic, it cannot be chained and is prone to overflow 
problems when given -32768, but it is smaller than the absolute-kludge 
wrapped around an unsigned mutiply, and not much slower (633-943 cycles). 

Enter with A,Y = MULTIPLIER (A=MSB) 

ACC = MULTIPLICAND 

16 * 16 SIGNED MULTIPLY 

Exit with ACC,MQ = 32 BIT PRODUCT 
ACC = MSW 
MQ = LSW 

ACC r 212 
• MQ = $0CB 
ENT = $0CD 
SC = $0CF 
* = $600 




This APX diskette is unnotched to protect the software against 
accidental erasure* However# this protection also prevents a program 
from storing information on the diskette* The program you've 
purchased involves storing information* Therefore# before you can use 
the program# you must duplicate the contents of the diskette onto a 
notched diskette that doesn't have a write-protect tab covering the 
notch* 

To duplicate the diskette# call the Disk Operating System (DOS) menu 
and select option J# Duplicate Disk. You can use this option with a 
single disk drive by manually swapping source (the APX diskette) and 
destination (a notched diskette) until the duplication process is 
complete* You can also use this option with multiple disk drive 
systems by inserting source and destination diskettes in two separate 
drives and letting the duplication process proceed automatically* 

(Note* This option copies sector by sector* Therefore# when the 
duplication is complete# any files previously stored on the 
destination diskette will have been destroyed*) 




DIV 


This routine is composed of two assembly subroutines: Unsigned Divide of 
32/16 bits and Signed Divide of 16/16 bits. 


Unsigned Divide: 


Enter with A,Y 
ACC,MQ 


Divisor (A=MSB) 
Dividend 


Exit with ACC 
MQ 


Remainder 

Quotient 


Signed Divide: 


Enter with A,Y 
ACC 


Divisor (A=MSB) 
Dividend 


Exit with ACC 
MQ 


Remainder 

Quotient 


SMUL 


This routine is composed of a 16 * 16 Unsigned Multiply and a 16 * 16 
Signed Multiply. 


Unsigned Multiply: 

Enter with A,Y = MULTIPLIER 

ENT = MULTIPLICAND 
ACC = ADDEND 

(ACC,MQ) r ([A,Y]*ENT)+ACC 
(This way for chained operaton) 
536-748 Cycles 

Signed Multiply: 


Enter with A,Y = MULTIPLIER (A=MSB) 
ACC = MULTIPLICAND 


Exit with ACC,MQ = PRODUCT 
ACC = MSW 


584-821 Cycles 



Mi S T" X 


M8TXT deMonstrstes how to Mix text with graphics in BASIC node 
8 * It plots the characters bit by bit onto the node 8 screen* The 
technique can be adapted to any program using BASIC node 8 displays* 


EEs O D S iAi ">J 

This program provides an alternative to the variable length 
records obtained when a program PRINTS values to the disk* Using the 
variable table values, it stores BCD values of numbers to the disk 
in fixed length records* 


ft—tt O 1E= IE: Y X 

This is a simple p1ayer-missi1e graphics demo* It sets up a 
player and then moves it around with the Joystick* Since this is & 
pure BASIC program, the vertical motion of the player is too slow* 
An assembly language routine is necessary to get proper high-speed 
motion* 


D-8 O IE: EE: Y 2 

This is a simple display list interrupt demo program* The 
bottom half of the screen changes from blue to pink* 

EE: UILD24 

This program creates an AUTORUN*SYS file that will start up 
Hour E'-ASIC programs* It asks you for a BASIC command; the command 
you enter will be in the AUTORUN*SYS file and will be executed on 
powerup* Normally your command will be of the form RUN"D:PROG♦BAS"♦ 
It must be less than 128 characters long* Remember to put in the 
terminating double quotation mark (")♦ 


M D m 1R 


This program is an object file that can be called from BASIC to 
put the disk directory onto the screen* To use it, you must first 
load it into RAN with the BINARY LOAD command <L> in the DOS* Call 
it from BASIC with A*USR<1536>* 


AUTORUN SYS 

This program is an RS-232 handler file* It allows you to use 
the R* device* It is booted in automatically on oowerup* 




HI O IF: S E 3 O * fl~> «r"-h S 

This is the running horse deno ♦ It denonstr ates the power of 
character set graphics and animation* 


S C IF: L_ 0—Q ID* IE M 

This is a sinple horizontal coarse scroll deno* 


SCRLV * DEM 

This is a sinple vertical coarse scroll deno* 


SCRLF * D E iMi 
This is a sinple fine scroll deno* 


M D II_IE O 2: ♦ IE: ,A, S 

This is a Multiple d i S p lay list interrupt deno* It p ijts gobs of 
color onto the screen* Do not be alarned if the screen goes blackJ 
it takes several Minutes to finish* Once it is running observe how 
keypresses affect the display* Also note the greatly reduced 
coMPutation speed of BASIC* With so Many interrupts happening , the 
6502 has little tine for other activities* 


DEM 03 BOK 

This progran denonstr 51es a technique for increasing the 
resolution of a stationary player by hiding it behind a playfield 
c u t a u t ♦ 


DEMO^I ♦ D.A.S 

This progran shows how a player can be used as an extended 
character♦ 


DLISTA HD EM 

This progran denonstrates the alternating display list 
technique* 



—H 




DISCLAIMER OF WARRANTY AND LIABILITY ON COMPUTER PROGRAMS 


Neither Atari* Inc* ("ATARI")* nor its software supplier* distributor* or dealers 
make any express or implied warranty of any kind with respect to this computer 
software program and/or material* including* but not limited to warranties of 
merchantability and fitness for a particular purpose* This computer program software 
and/or material is distributed solely on an "as is" basis* The entire risk as to the 
quality and performance of such programs is with the purchaser* Purchaser accepts 
and uses this computer program software and/or material upon his/her own inspection 
of the computer software program and/or material* without reliance upon any 
representation or description concerning the computer program software and/or 
material* Should the computer program software and/or material prove defective* 
purchaser and not ATARI* its software supplier* distributor* or dealer* assumes the 
entire cost of all necessary servicing* repair* or correction* and any incidental 
damages. 

In no event shall ATARI* or its software supplier* distributor* or dealer be liable 
or responsible to a purchaser* customer* or any other person or entity with respect 
to any liability* loss* incidental or consequential damage caused or alleged to be 
caused* directly or indirectly* by the computer program software and/or material* 
whether defective or otherwise* even if they have been advised of the possibility of 
such liability* loss* or damage* 


LIMITED WARRANTIES ON MEDIA AND HARDWARE ACCESSORIES 

ATARI warrants to the original consumer purchaser that the media on which the 
computer software program and/or material is recorded* including computer program 
cassettes or diskettes* and all hardware accessories are free from defects in 
materials or workmanship for a period of 30 days from the date of purchase* If a 
defect covered by this limited warranty is discovered during this 30-day warranty 
period* ATARI will repair or replace the media or hardware accessories* at ATARI'S 
option* provided the media or hardware accessories and proof of date of purchase are 
delivered or mailed* postage prepaid* to the ATARI Program Exchange* 

This warranty shall not apply if the media or hardware accessories (1) have been 
misused or show signs of excessive wear* (2) have been damaged by playback equipment 
or by being used with any products not supplied by ATARI, or (3) if the purchaser 
causes or permits the media or hardware accessories to be serviced or modified by 
anyone other than an authorized ATARI Service Center* Any applicable implied 
warranties on media or hardware accessories* including warranties of merchantability 
and fitness* are hereby limited to 30 days from the date of purchase* Consequential 
or incidental damages resulting from a breach of any applicable express or implied 
warranties on media or hardware accessories are hereby excluded* Some states do not 
allow limitations on how long an implied warranty lasts* so the above limitation may 
not apply to you* Some states also do not allow the exclusion or limitation of 
incidental or consequential damage* so the above limitation or exclusion may not 
apply to you. 





ATARI PROGRAM EXCHANGE 


REVIEW FORM 


We're interested in your experiences with APX programs and documentation, both favorable and 
unfavorable* Many software authors are willing and eager to improve their programs if they know 
what users want* And* of course, we want to know about any bugs that slipped bv us* so that the 
software author can fix them* We also want to know whether our documentation is meeting your needs* 
You are our best source for suggesting improvements! Please help us by taking a moment to fill in 
this review sheet* Fold the sheet in thirds and seal it so that the address on the bottom of the 
back becomes the envelope front* Thank you for helping us! 

1* Name and APX number of program_ 

2* If you have problems using the program, please describe them here* 


3* What do you especially like about this program? 


4* What do you think the program's weaknesses are? 


5* Kow can the catalog description be more accurate and/or comprehensive? 


6* On a scale of 1 to 10* 1 being "poor" and 10 being "excellent", please rate the following 
aspects of this program? 

_Easy to use 

_User-oriented (e*g*, menus, prompts, clear language) 

_Enjoyable 

_Self-instructuve 

_Useful (non-game software) 

_Imaginative graphics and sound 


7* Describe any technical errors you found in the user instructions (please give page numbers)* 







8* What did you especially like about the user instructions? 


9* What revisions or additions would improve these instructions? 


10* On a scale of 1 to 10* 1 representing “poor" and 10 representing "excellent"* how would you 


rate the user instructions and why 



!!♦ Other comments about the software or user instructions: 


1STAMFI 


ATARI Program Exchange 


P.O* Box 427 

155 Moffett Park Drive, E- 
Sunnyvale, CA 94086 


1 



[seal here] 





